SGI Freeware 1999 August/SGI Freeware 1999 August.iso/dist/fw_mc.idb/usr/freeware/catman/u_man/cat1/mc.Z/mc

Text File | 1998-10-28 | 130.3 KB | 3,301 lines

     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



     NNNNAAAAMMMMEEEE
      mc - Visual shell for    Unix-like systems.

     UUUUSSSSAAAAGGGGEEEE
      mmmmcccc [-abcCdfhPstuUVx?]    [-l log] [dir1 [dir2]] [-v file]

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
      The Midnight Commander is a directory    browser/file manager
      for Unix-like    operating systems.

     OOOOPPPPTTTTIIIIOOOONNNNSSSS
      -_a   Disables    the usage of graphic characters    for line
           drawing.

      -_b   Forces black and    white display.

      -_c   Force color mode, please    check the section Colors for
           more information.

      -_C _a_r_g
           Used to specify a different color set in    the command
           line.  The format of arg    is documented in the Colors
           section.

      -_d   Disables    mouse support.

      -_f   Displays    the compiled-in    search paths for Midnight
           Commander files.

      -_k   Reset softkeys to their default from the
           termcap/terminfo    database. Only useful on HP terminals
           when the    function keys don't work.

      -_l _f_i_l_e
           Save the    ftpfs dialog with the server in    file.

      -_P   At program end, the Midnight Commander will print the
           last working directory; this, along with    the shell
           function    below, will allow you to browse    through    your
           directories and automatically move to the last
           directory you were in (thanks to    Torben Fjerdingstad
           and Sergey for contributing this    function and the code
           which implements    this option).

           bash and    zsh users:

           mc ()
           {
               MC=/tmp/mc$$-"$RANDOM"
               /usr/freeware/bin/mc -P "$@" > "$MC"
               cd "`cat    $MC`"
               rm "$MC"



     Page 1                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



               unset MC;
           }

           tcsh users:
           alias mc    'setenv    MC `/usr/freeware/bin/mc -P *`;    cd $MC;    unsetenv MC'

     the
      I know the bash function could be shorter for    zsh and    bash but
           backquotes on bash won't    accept your suspension the
           program with C-z.

      -_s   Turns on    the slow terminal mode,    in this    mode the
           program will not    draw expensive line drawing characters
           and will    toggle verbose mode off.

      -_t   Used only if the    code was compiled with Slang and
           terminfo: it makes the Midnight Commander use the value
           of the TTTTEEEERRRRMMMMCCCCAAAAPPPP variable for the terminal    information
           instead of the information on the system    wide terminal
           database

      -_u   Disables    the use    of a concurrent    shell (only makes
           sense if    the Midnight Commander has been    built with
           concurrent shell    support).

      -_U   Enables the use of the concurrent shell support (only
           makes sense if the Midnight Commander was built with
           the subshell support set    as an optional feature).

      -_v _f_i_l_e
           Enters the internal viewer to view the file specified.

      -_V   Displays    the version of the program.

      -_x   Forces xterm mode.  Used    when running on    xterm-capable
           terminals (two screen modes, and    able to    send mouse
           escape sequences).

      If specified,    the first path name is the directory to    show
      in the selected panel; the second path name is the directory
      to be    shown in the other panel.

     OOOOvvvveeeerrrrvvvviiiieeeewwww
      The screen of    the Midnight Commander is divided into four
      parts. Almost    all of the screen space    is taken up by two
      directory panels.  By    default, the second bottommost line of
      the screen is    the shell command line,    and the    bottom line
      shows    the function key labels. The topmost line is the menu
      bar line.  The menu bar line may not be visible, but appears
      if you click the topmost line    with the mouse or press    the F9
      key.




     Page 2                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      The Midnight Commander provides a view of two    directories at
      the same time. One of    the panels is the current panel    (a
      selection bar    is in the current panel). Almost all
      operations take place    on the current panel. Some file
      operations like Rename and Copy by default use the directory
      of the unselected panel as a destination (don't worry, they
      always ask you for confirmation first). For more
      information, see the sections    on the Directory Panels, the
      Left and Right Menus and the File Menu.

      You can execute system commands from the Midnight Commander
      by simply typing them. Everything you    type will appear on
      the shell command line, and when you press Enter the
      Midnight Commander will execute the command line you typed;
      read the Shell Command Line and Input    Line Keys sections to
      learn    more about the command line.

     MMMMoooouuuusssseeee SSSSuuuuppppppppoooorrrrtttt
      The Midnight Commander comes with mouse support.  It is
      activated whenever you are running on    an xxxxtttteeeerrrrmmmm((((1111)))) terminal
      (it even works if you    take a telnet or rlogin    connection to
      another machine from the xterm) or if    you are    running    on a
      Linux    console    and have the ggggppppmmmm mouse server running.

      When you left    click on a file    in the directory panels, that
      file is selected; if you click with the right    button,    the
      file is marked (or unmarked, depending on the    previous
      state).

      Double-clicking on a file will try to    execute    the command if
      it is    an executable program; and if the extension file has a
      program specified for    the file's extension, the specified
      program is executed.

      Also,    it is possible to execute the commands assigned    to the
      function key labels by clicking on them.

      If a mouse button is clicked on the top frame    line of    the
      directory panel, it is scrolled one pageful backward.
      Correspondingly, a click on the bottom frame line will cause
      a scroll of one pageful forward. This    frame line method
      works    also in    the Help Viewer    and the    Directory Tree.

      The default auto repeat rate for the mouse buttons is    400
      milliseconds.    This may be changed to other values by editing
      the ~/.mc/ini    file and changing the _m_o_u_s_e__r_e_p_e_a_t__r_a_t_e
      parameter.

      If you are running the Commander with    the mouse support, you
      can bypass the Commander and get the default mouse behavior
      (cutting and pasting text) by    holding    down the Shift key.




     Page 3                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))




     KKKKeeeeyyyyssss
      Some commands    in the Midnight    Commander involve the use of
      the _C_o_n_t_r_o_l (sometimes labeled CTRL or CTL) and the _M_e_t_a
      (sometimes labeled ALT or even Compose) keys.    In this    manual
      we will use the following abbreviations:

      C-<chr> means    hold the Control key while typing the
      character <chr>. Thus    C-f would be: hold the Control key and
      type f.

      M-<chr> means    hold the Meta or Alt key down while typing
      <chr>. If there is no    Meta or    Alt key, type ESC, release it,
      then type the    character <chr>.

      All input lines in the Midnight Commander use    an
      approximation    to the GNU Emacs editor's key bindings.

      There    are many sections which    tell about the keys. The
      following are    the most important.

      The File Menu    section    documents the keyboard shortcuts for
      the commands appearing in the    File menu. This    section
      includes the function    keys. Most of these commands perform
      some action, usually on the selected file or the tagged
      files.

      The Directory    Panels section documents the keys which    select
      a file or tag    files as a target for a    later action (the
      action is usually one    from the file menu).

      The Shell Command Line section list the keys which are used
      for entering and editing command lines. Most of these    copy
      file names and such from the directory panels    to the command
      line (to avoid excessive typing) or access the command line
      history.

      Input    Line Keys are used for editing input lines. This means
      both the command line    and the    input lines in the query
      dialogs.

       MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss KKKKeeeeyyyyssss
      Here are some    keys which don't fall into any of the other
      categories:

      EEEEnnnntttteeeerrrr.... If there is some text in the command line (the    one at
      the bottom of    the panels), then that command is executed. If
      there    is no text in the command line then if the selection
      bar is over a    directory the Midnight Commander does a
      cccchhhhddddiiiirrrr((((2222)))) to the selected directory and reloads the
      information on the panel; if the selection is    an executable
      file then it is executed. Finally, if    the extension of the



     Page 4                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      selected file    name matches one of the    extensions in the
      extensions file then the corresponding command is executed.

      CCCC----llll.... Repaint all the information in the Midnight Commander.

      CCCC----xxxx cccc.... Run the Chmod command on a file or on the tagged
      files.

      CCCC----xxxx oooo.... Run the Chown command on the current file or on the
      tagged files.

      CCCC----xxxx llll.... Run the link command.

      CCCC----xxxx ssss.... Run the symbolic link command.

      CCCC----xxxx iiii.... Set the other panel display mode to information.

      CCCC----xxxx qqqq.... Set the other panel display mode to quick view.

      CCCC----xxxx !!!!.... Execute the External panelize command.

      CCCC----xxxx hhhh    Run the    add directory to hotlist command.

      MMMM----!!!!,,,, Executes    the Filtered view command, described in    the
      view command.

      MMMM----????,,,, Executes    the Find file command.

      MMMM----cccc,,,, Pops up the quick cd dialog.

      CCCC----oooo,,,, When the    program    is being run in    the Linux or SCO
      console or under an xterm, it    will show you the output of
      the previous command.     When ran on the Linux console,    the
      Midnight Commander uses an external program (cons.saver) to
      handle saving    and restoring of information on    the screen.

      When the subshell support is compiled    in, you    can type C-o
      at any time and you will be taken back to the    Midnight
      Commander main screen, to return to your application just
      type C-o.  If    you have an application    suspended by using
      this trick, you won't    be able    to execute other programs from
      the Midnight Commander until you terminate the suspended
      application.

       DDDDiiiirrrreeeeccccttttoooorrrryyyy PPPPaaaannnneeeellllssss
      This section lists the keys which operate on the directory
      panels. If you want to know how to change the    appearance of
      the panels take a look at the    section    on Left    and Right
      Menus.

      TTTTaaaabbbb,,,, CCCC----iiii.... Change the current panel. The old other panel
      becomes the new current panel    and the    old current panel



     Page 5                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      becomes the new other    panel. The selection bar moves from
      the old current panel    to the new current panel.

      IIIInnnnsssseeeerrrrtttt,,,, CCCC----tttt.... To tag files you    may use    the Insert key (the
      kich1    terminfo sequence) or the C-t (Control-t) sequence. To
      untag    files, just retag a tagged file.

      MMMM----gggg,,,, MMMM----hhhh ((((oooorrrr MMMM----rrrr)))),,,, MMMM----jjjj.... Used to select the top file in a
      panel, the middle file and the bottom    one, respectively.

      CCCC----ssss,,,, MMMM----ssss.... Start a filename search in the directory listing.
      When the search is active the    keypresses will    be added to
      the search string instead of the command line. If the    _S_h_o_w
      _m_i_n_i-_s_t_a_t_u_s option is    enabled    the search string is shown on
      the mini-status line.    When typing, the selection bar will
      move to the next file    starting with the typed    letters. The
      _b_a_c_k_s_p_a_c_e _o_r _D_E_L keys    can be used to correct typing
      mistakes. If C-s is pressed again, the next match is
      searched for.

      MMMM----tttt Toggle the current display listing to show the next
      display listing mode.     With this it is possible to quickly
      switch from long listing to regular listing and the user
      defined listing mode.

      CCCC----\\\\ ((((ccccoooonnnnttttrrrroooollll----bbbbaaaacccckkkkssssllllaaaasssshhhh)))).... Show    the directory hotlist and
      change to the    selected directory.

      ++++  ((((pppplllluuuussss)))).... This is used to select (tag) a group of files.
      The Midnight Commander will prompt for a regular expression
      describing the group.    When _S_h_e_l_l _P_a_t_t_e_r_n_s are    enabled, the
      regular expression is    much like the regular expressions in
      the shell (* standing    for zero or more characters and    ?
      standing for one character). If _S_h_e_l_l    _P_a_t_t_e_r_n_s is off, then
      the tagging of files is done with normal regular expressions
      (see ed (1)).

      If the expression starts or ends with    a slash    (/), then it
      will select directories instead of files.

      \\\\ ((((bbbbaaaacccckkkkssssllllaaaasssshhhh)))).... Use the "\" key to unselect a group of    files.
      This is the opposite of the Plus key.

      uuuupppp----kkkkeeeeyyyy,,,, CCCC----pppp.... Move the    selection bar to the previous entry in
      the panel.

      ddddoooowwwwnnnn----kkkkeeeeyyyy,,,, CCCC----nnnn.... Move the selection bar    to the next entry in
      the panel.

      hhhhoooommmmeeee,,,,    aaaa1111,,,, MMMM----<<<<.... Move the selection bar    to the first entry in
      the panel.




     Page 6                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      eeeennnndddd,,,, cccc1111,,,, MMMM---->>>>....    Move the selection bar to the last entry in
      the panel.

      nnnneeeexxxxtttt----ppppaaaaggggeeee,,,, CCCC----vvvv.... Move the selection bar one page down.

      pppprrrreeeevvvv----ppppaaaaggggeeee,,,, MMMM----vvvv.... Move the selection bar one page up.

      MMMM----oooo,,,, If the other panel is a listing panel and you are
      standing on a    directory in the current panel,    then the other
      panel    contents are set to the    contents of the    currently
      selected directory (like Emacs' dired    C-o key) otherwise the
      other    panel contents are set to the parent dir of the
      current dir.

      CCCC----PPPPaaaaggggeeeeUUUUpppp,,,, CCCC----PPPPaaaaggggeeeeDDDDoooowwwwnnnn Only when ran on    the Linux console:
      does a chdir to ".." and to the currently selected directory
      respectively.

       SSSShhhheeeellllllll CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee
      This section lists keys which    are useful to avoid excessive
      typing when entering shell commands.

      MMMM----EEEEnnnntttteeeerrrr.... Copy    the currently selected file name to the
      command line.

      CCCC----EEEEnnnntttteeeerrrr.... Same    a M-Enter, this    one only works on the Linux
      console.

      MMMM----TTTTaaaabbbb.... Does the filename, command, variable, username    and
      hostname completion for you.

      CCCC----xxxx tttt,,,, CCCC----xxxx CCCC----tttt.... Copy the tagged files    (or if there are no
      tagged files,    the selected file) of the current panel    (C-x
      t) or    of the other panel (C-x    C-t) to    the command line.

      CCCC----xxxx pppp,,,, CCCC----xxxx CCCC----pppp.... The first key    sequence copies    the current
      path name to the command line, and the second    one copies the
      unselected panel's path name to the command line.

      CCCC----qqqq.... The quote command can be    used to    insert characters that
      are otherwise    interpreted by the Midnight Commander (like
      the '+' symbol)

      MMMM----pppp,,,, MMMM----nnnn.... Use    these keys to browse through the command
      history. M-p takes you to the    last entry, M-n    takes you to
      the next one.

      MMMM----hhhh.... Displays    the history for    the current input line.

       GGGGeeeennnneeeerrrraaaallll MMMMoooovvvveeeemmmmeeeennnntttt    KKKKeeeeyyyyssss
      The help viewer, the file viewer and the directory tree use
      common code to handle    moving.    Therefore they accept exactly



     Page 7                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      the same keys. Each of them also accepts some    keys of    its
      own.

      Other    parts of the Midnight Commander    use some of the    same
      movement keys, so this section may be    of use for those parts
      too.

      UUUUpppp,,,, CCCC----pppp.... Moves one line backward.

      DDDDoooowwwwnnnn,,,,    CCCC----nnnn.... Moves one line forward.

      PPPPrrrreeeevvvv PPPPaaaaggggeeee,,,, PPPPaaaaggggeeee UUUUpppp,,,, MMMM----vvvv.... Moves one pageful backward.

      NNNNeeeexxxxtttt PPPPaaaaggggeeee,,,, PPPPaaaaggggeeee DDDDoooowwwwnnnn,,,,    CCCC----vvvv.... Moves one pageful forward.

      HHHHoooommmmeeee,,,,    AAAA1111.... Moves to the beginning.

      EEEEnnnndddd,,,, CCCC1111.... Move    to the end.

      The help viewer and the file viewer accept the following
      keys in addition the to ones mentioned above:

      bbbb,,,, CCCC----bbbb,,,, CCCC----hhhh,,,, BBBBaaaacccckkkkssssppppaaaacccceeee,,,, DDDDeeeelllleeeetttteeee.... Moves    one pageful backward.

      SSSSppppaaaacccceeee    bbbbaaaarrrr.... Moves one pageful forward.

      uuuu,,,, dddd....    Moves one half of a page backward or forward.

      gggg,,,, GGGG....    Moves to the beginning or to the end.

       IIIInnnnppppuuuutttt LLLLiiiinnnneeee KKKKeeeeyyyyssss
      The input lines (they    are used for the command line and for
      the query dialogs in the program) accept these keys:

      CCCC----aaaa puts the cursor at the beginning of line.

      CCCC----eeee puts the cursor at the end of the    line.

      CCCC----bbbb,,,, mmmmoooovvvveeee----lllleeeefffftttt move the cursor one position left.

      CCCC----ffff,,,, mmmmoooovvvveeee----rrrriiiigggghhhhtttt move the cursor one position right.

      MMMM----ffff moves one    word forward.

      MMMM----bbbb moves one    word backward.

      CCCC----hhhh,,,, bbbbaaaacccckkkkssssppppaaaacccceeee delete    the previous character.

      CCCC----dddd,,,, DDDDeeeelllleeeetttteeee delete the character in the point    (over the
      cursor).

      CCCC----@@@@ sets the mark for    cutting.



     Page 8                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      CCCC----wwww copies the text between the cursor and the mark to a
      kill buffer and removes the text from    the input line.

      MMMM----wwww copies the text between the cursor and the mark to a
      kill buffer.

      CCCC----yyyy yanks back the contents of the kill buffer.

      CCCC----kkkk kills the    text from the cursor to    the end    of the line.

      MMMM----pppp,,,, MMMM----nnnn Use these keys to browse through the    command
      history. M-p takes you to the    last entry, M-n    takes you to
      the next one.

      MMMM----CCCC----hhhh,,,, MMMM----BBBBaaaacccckkkkssssppppaaaacccceeee delete one    word backward.

      MMMM----TTTTaaaabbbb    does the filename, command, variable, username and
      hostname completion for you.


     MMMMeeeennnnuuuu BBBBaaaarrrr
      The menu bar pops up when you    press F9 or click the mouse on
      the top row of the screen. The menu bar has five menus:
      "Left", "File", "Command", "Options" and "Right".

      The Left and Right Menus allow you to    modify the appearance
      of the left and right    directory panels.

      The File Menu    lists the actions you can perform on the
      currently selected file or the tagged    files.

      The Command Menu lists the actions which are more general
      and bear no relation to the currently    selected file or the
      tagged files.

       LLLLeeeefffftttt aaaannnndddd    RRRRiiiigggghhhhtttt MMMMeeeennnnuuuussss
      The outlook of the directory panels can be changed from the
      LLLLeeeefffftttt and RRRRiiiigggghhhhtttt menus.

     LLLLiiiissssttttiiiinnnngggg MMMMooooddddeeee............
      The listing mode view    is used    to display a listing of    files,
      there    are four different listing modes available:  FFFFuuuullllllll,,,,
      BBBBrrrriiiieeeeffff,,,, LLLLoooonnnngggg,,,, and UUUUsssseeeerrrr.... The full directory view shows the
      file name, the size of the file and the modification time.

      The brief view shows only the    file name and it has two
      columns (therefore showing twice as many files as other
      views). The long view    is similar to the output of llllssss ----llll
      command. The long view takes the whole screen    width.

      If you choose    the "User" display format, then    you have to
      specify the display format.



     Page 9                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      The user display format must start with a panel size
      specifier.  This may be "half" or "full", and    they specify a
      half screen panel and    a full screen panel respectively.

      After    the panel size,    you may    specify    the two    columns    mode
      on the panel,    this is    done by    adding the number "2" to the
      user format string.

      After    this you add the name of the fields with an optional
      size specifier.  This    are the    available fields you may
      display:

      nnnnaaaammmmeeee,,,,    displays the file name.

      ssssiiiizzzzeeee,,,,    displays the file size.

      bbbbssssiiiizzzzeeee,,,, is an alternative form    of the <bf/size/ format. It
      displays the size of the files and for directories it    just
      shows    SUB-DIR    or UP--DIR.

      ttttyyyyppppeeee,,,,    displays a one character field type.  This character
      is a superset    of what    is displayed by    ls with    the -F flag.
      An asterisk for executable files, a slash for    directories,
      an at-sign for links,    an equal sign for sockets, a hyphen
      for character    devices, a plus    sign for block devices,    a pipe
      for fifos, a tilde for symbolic links    to directories and an
      exclamation mark for stalled symlinks    (links that point
      nowhere).

      mmmmttttiiiimmmmeeee,,,, file's    last modification time.

      aaaattttiiiimmmmeeee,,,, file's    last access time.

      ccccttttiiiimmmmeeee,,,, file's    creation time.

      ppppeeeerrrrmmmm,,,,    a string representing the current permission bits of
      the file.

      mmmmooooddddeeee,,,,    an octal value with the    current    permission bits    of the
      file.

      nnnnlllliiiinnnnkkkk,,,, the number of links to    the file.  nnnnggggiiiidddd,,,, the GID
      (numeric).

      nnnnuuuuiiiidddd,,,,    the UID    (numeric).

      oooowwwwnnnneeeerrrr,,,, the owner of the file.

      ggggrrrroooouuuupppp,,,, the group of the file.

      iiiinnnnooooddddeeee,,,, the inode of the file.




     Page 10                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      Also you may use these field names for arranging the
      display:

      ssssppppaaaacccceeee,,,, a space in the    display    format.

      mmmmaaaarrrrkkkk,,,,    An asterisk if the file    is tagged, a space if it's
      not.

      ||||,,,, This character is used to add a vertical line to the
      display format.

      To force one field to    a fixed    size (a    size specifier), you
      just add a ':' and then the number of    characters you want
      the field to have, if    the number is followed by the symbol
      '+', then the    size specifies the minimum field size, if the
      program finds    out that there is more space on    the screen, it
      will then expand this    field.

      For example, the FFFFuuuullllllll    display    corresponds to this format:

      half type,name,|,size,|,mtime

      And the LLLLoooonnnngggg display corresponds to this format:

      full
      perm,space,nlink,space,owner,space,group,space,size,space,
      mtime,space,name

      This is a nice user display format:

      half name,|,size:7,|,type,mode:3

      Panels may also be set to the    following modes:

      IIIInnnnffffoooo The info    view display information related to the
           currently selected file and if possible information
           about the current file system.

      TTTTrrrreeeeeeee The tree    view is    quite similar to the directory tree
           feature.    See the    section    about it for more information.

      QQQQuuuuiiiicccckkkk    VVVViiiieeeewwww
           In this mode, the panel will switch to a    reduced    viewer
           that displays the contents of the currently selected
           file, if    you select the panel (with the tab key or the
           mouse), you will    have access to the usual viewer
           commands.

     SSSSoooorrrrtttt OOOOrrrrddddeeeerrrr............
      The eight sort orders    are by name, by    extension, by
      modification time, by    access time, and by inode information
      modification time, by    size, by inode and unsorted.  In the



     Page 11                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      Sort order dialog box    you can    choose the sort    order and you
      may also specify if you want to sort in reverse order    by
      checking the reverse box.

      By default directories are sorted before files but this can
      be changed from the Options menu (option MMMMiiiixxxx aaaallllllll ffffiiiilllleeeessss ).

     FFFFiiiilllltttteeeerrrr............
      The filter command allows you    to specify a shell pattern
      (for example ****....ttttaaaarrrr....ggggzzzz    ) which    the files must match to    be
      shown. Regardless of the filter pattern, the directories and
      the links to directories are always shown in the directory
      panel.

     RRRReeeerrrreeeeaaaadddd
      The reread command reload the    list of    files in the
      directory. It    is useful if other processes have created or
      removed files.  If you have panelized    file names in a    panel
      this will reload the directory contents and remove the
      panelized information    (See the section External panelize for
      more information).

       FFFFiiiilllleeee MMMMeeeennnnuuuu
      The Midnight Commander uses the F1 - F10 keys    as keyboard
      shortcuts for    commands appearing in the file menu. The
      escape sequences for the Fkeys are terminfo capabilities kf1
      trough kf10.    On terminals without function key support, you
      can achieve the same functionality by    pressing the ESC key
      and then a number in the range 1 through 9 and 0
      (corresponding to F1 to F9 and F10 respectively).

      The File menu    has the    following commands (keyboard shortcuts
      in parentheses):

      HHHHeeeellllpppp ((((FFFF1111))))

      Invokes the built-in hypertext help viewer. Inside the help
      viewer, you can use the Tab key to select the    next link and
      the Enter key    to follow that link. The keys Space and
      Backspace are    used to    move forward and backward in a help
      page.    Press F1 again to get the full list of accepted    keys.

      MMMMeeeennnnuuuu ((((FFFF2222))))

      Invoke the user menu.     The user menu provides    an easy    way to
      provide users    with a menu and    add extra features to the
      Midnight Commander.

      VVVViiiieeeewwww ((((FFFF3333,,,, SSSShhhhiiiifffftttt----FFFF3333))))

      View the currently selected file. By default this invokes
      the Internal File Viewer but if the option "Use internal



     Page 12                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      view"    is off,    it invokes an external file viewer specified
      by the PPPPAAAAGGGGEEEERRRR environment variable. If    PPPPAAAAGGGGEEEERRRR is undefined,
      the "view" command is    invoked.  If you use Shift-F3 instead,
      the viewer will be invoked without doing any formatting or
      pre processing to the    file.

      FFFFiiiilllltttteeeerrrreeeedddd VVVViiiieeeewwww    ((((MMMM----!!!!))))

      this command prompts for a command and it's arguments    (the
      argument defaults to the currently selected file name), the
      output from such command is shown in the internal file
      viewer.

      EEEEddddiiiitttt ((((FFFF4444))))

      Currently it invokes the vvvviiii editor, or the editor specified
      in the EEEEDDDDIIIITTTTOOOORRRR    environment variable, or the Internal File
      Editor if the    use_internal_edit option is on.

      CCCCooooppppyyyy ((((FFFF5555))))

      Pop up an input dialog with destination that defaults    to the
      directory in the non-selected    panel and copies the currently
      selected file    (or the    tagged files, if there is at least one
      file tagged) to the directory    specified by the user in the
      input    dialog.    During this process, you can press C-c or ESC
      to abort the operation. For details about source mask    (which
      will be usually either * or ^\(.*\)$ depending on setting of
      Use shell patterns) and possible wildcards in    the
      destination see Mask copy/rename.

      On some systems, it is possible to do    the copy in the
      background by    clicking on the    background button (or pressing
      M-b in the dialog box).  The Background Jobs is used to
      control the background process.

      LLLLiiiinnnnkkkk ((((CCCC----xxxx llll))))

      Create a hard    link to    the current file.

      SSSSyyyymmmmLLLLiiiinnnnkkkk ((((CCCC----xxxx ssss))))

      Create a symbolic link to the    current    file. To those of you
      who don't know what links are: creating a link to a file is
      a bit    like copying the file, but both    the source filename
      and the destination filename represent the same file image.
      For example, if you edit one of these    files, all changes you
      make will appear in both files. Some people call links
      aliases or shortcuts.

      A hard link appears as a real    file. After making it, there
      is no    way of telling which one is the    original and which is



     Page 13                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      the link. If you delete either one of    them the other one is
      still    intact.    It is very difficult to    notice that the    files
      represent the    same image. Use    hard links when    you don't even
      want to know.

      A symbolic link is a reference to the    name of    the original
      file.    If the original    file is    deleted    the symbolic link is
      useless. It is quite easy to notice that the files represent
      the same image. The Midnight Commander shows an "@"-sign in
      front    of the file name if it is a symbolic link to somewhere
      (except to directory,    where it shows a tilde (~)).  The
      original file    which the link points to is shown on mini-
      status line if the _S_h_o_w _m_i_n_i-_s_t_a_t_u_s option is    enabled. Use
      symbolic links when you want to avoid    the confusion that can
      be caused by hard links.

      RRRReeeennnnaaaammmmeeee////MMMMoooovvvveeee ((((FFFF6666))))

      Pop up an input dialog that defaults to the directory    in the
      non-selected panel and moves the currently selected file (or
      the tagged files if there is at least    one tagged file) to
      the directory    specified by the user in the input dialog.
      During the process, you can press C-c    or ESC to abort    the
      operation. For more details look at Copy operation above,
      most of the things are quite similar.

      On some systems, it is possible to do    the copy in the
      background by    clicking on the    background button (or pressing
      M-b in the dialog box). The Background Jobs is used to
      control the background process.

      MMMMkkkkddddiiiirrrr    ((((FFFF7777))))

      Pop up an input dialog and creates the directory specified.

      DDDDeeeelllleeeetttteeee ((((FFFF8888))))

      Delete the currently selected    file or    the tagged files in
      the currently    selected panel.    During the process, you    can
      press    C-c or ESC to abort the    operation.

      QQQQuuuuiiiicccckkkk    ccccdddd ((((MMMM----cccc)))) Use the quick cd command if you have full
      command line and want    to cd somewhere.

      SSSSeeeelllleeeecccctttt ggggrrrroooouuuupppp ((((++++))))

      This is used to select (tag) a group of files. The Midnight
      Commander will prompt    for a regular expression describing
      the group. When _S_h_e_l_l    _P_a_t_t_e_r_n_s are enabled, the regular
      expression is    much like the filename globbing    in the shell
      (* standing for zero or more characters and ?     standing for
      one character). If _S_h_e_l_l _P_a_t_t_e_r_n_s is off, then the tagging



     Page 14                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      of files is done with    normal regular expressions (see    ed
      (1)).

      To mark directories instead of files,    the expression must
      start    or end with a '/'.

      UUUUnnnnsssseeeelllleeeecccctttt ggggrrrroooouuuupppp ((((\\\\))))

      Used for unselecting a group of files. This is the opposite
      of the _S_e_l_e_c_t    _g_r_o_u_p command.

      QQQQuuuuiiiitttt ((((FFFF11110000,,,, SSSShhhhiiiifffftttt----FFFF11110000))))

      Terminate the    Midnight Commander.  Shift-F10 is used when
      you want to quit and you are using the shell wrapper.
      Shift-F10 will not take you to the last directory you
      visited with the Midnight Commander, instead it will stay at
      the directory    where you started the Midnight Commander.

     QQQQuuuuiiiicccckkkk ccccdddd
      This command is useful if you    have a full command line and
      want to cd somewhere without having to yank and paste    the
      command line.    This command pops up a small dialog, where you
      enter    everything you would enter after ccccdddd on the command
      line and then    you press enter. This features all the things
      that are already in the internal cd command.

       CCCCoooommmmmmmmaaaannnndddd MMMMeeeennnnuuuu
      The Directory    tree command shows a tree figure of the
      directories.

      The Find file    command    allows you to search for a specific
      file.    The "Swap panels" command swaps    the contents of    the
      two directory    panels.

      The "Panels on/off" command shows the    output of the last
      shell    command. This works only on xterm and on Linux and SCO
      console.

      The Compare directories (C-x d) command compares the
      directory panels with    each other. You    can then use the Copy
      (F5) command to make the panels identical. There are three
      compare methods. The quick method compares only file size
      and file date. The thorough method makes a full byte-by-byte
      compare. The thorough    method is not available    if the machine
      does not support the mmap(2) system call.  The size-only
      compare method just compares the file    sizes and does not
      check    the contents or    the date times,    it just    checks the
      file size.

      The Command history command shows a list of typed commands.
      The selected command is copied to the    command    line. The



     Page 15                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      command history can also be accessed by typing M-p or    M-n.

      The Directory    hotlist    (C-\) command makes changing of    the
      current directory to often used directories faster.

      The External panelize    allows you to execute an external
      program, and make the    output of that program the contents of
      the current panel.

      Extension file edit command allows you to specify programs
      to executed when you try to execute, view, edit and do a
      bunch    of other thing on files    with certain extensions
      (filename endings). The Menu file edit command may be    used
      for editing the user menu (which appears by pressing F2).

     DDDDiiiirrrreeeeccccttttoooorrrryyyy TTTTrrrreeeeeeee
      The Directory    Tree command shows a tree figure of the
      directories. You can select a    directory from the figure and
      the Midnight Commander will change to    that directory.

      There    are two    ways to    invoke the tree. The real directory
      tree command is available from Commands menu.    The other way
      is to    select tree view from the Left or Right    menu.

      To get rid of    long delays the    Midnight Commander creates the
      tree figure by scanning only a small subset of all the
      directories. If the directory    which you want to see is
      missing, move    to its parent directory    and press C-r (or F2).

      You can use the following keys:

      General movement keys    are accepted.

      EEEEnnnntttteeeerrrr.... In the    directory tree,    exits the directory tree and
      changes to this directory in the current panel. In the tree
      view,    changes    to this    directory in the other panel and stays
      in tree view mode in the current panel.

      CCCC----rrrr,,,, FFFF2222 ((((RRRReeeessssccccaaaannnn)))).... Rescan this    directory. Use this when the
      tree figure is out of    date:  it is missing subdirectories or
      shows    some subdirectories which don't    exist any more.

      FFFF3333 ((((FFFFoooorrrrggggeeeetttt)))).... Delete this directory from the tree figure. Use
      this to remove clutter from the figure. If you want the
      directory back to the    tree figure press F2 in    its parent
      directory.

      FFFF4444 ((((SSSSttttaaaattttiiiicccc////DDDDyyyynnnnaaaammmmiiiicccc)))).... Toggle between the dynamic navigation
      mode (default) and the static    navigation mode.

      In the static    navigation mode    you can    use the    Up and Down
      keys to select a directory. All known    directories are    shown.



     Page 16                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      In the dynamic navigation mode you can use the Up and    Down
      keys to select a sibling directory, the Left key to move to
      the parent directory,    and the    Right key to move to a child
      directory. Only the parent, sibling and children directories
      are shown, others are    left out. The tree figure changes
      dynamically as you traverse.

      FFFF5555 ((((CCCCooooppppyyyy)))).... Copy the directory.

      FFFF6666 ((((RRRReeeennnnMMMMoooovvvv)))).... Move the    directory.

      FFFF7777 ((((MMMMkkkkddddiiiirrrr)))).... Make a new directory below this directory.

      FFFF8888 ((((DDDDeeeelllleeeetttteeee)))).... Delete this directory from the file system.

      CCCC----ssss,,,, MMMM----ssss.... Search the next directory matching the search
      string. If there is no such directory    these keys will    move
      one line down.

      CCCC----hhhh,,,, BBBBaaaacccckkkkssssppppaaaacccceeee.... Delete the last character of the search
      string.

      AAAAnnnnyyyy ooootttthhhheeeerrrr cccchhhhaaaarrrraaaacccctttteeeerrrr.... Add the character to the    search string
      and move to the next directory which starts with these
      characters. In the tree view you must    first activate the
      search mode by pressing C-s. The search string is shown in
      the mini status line.

      The following    actions    are available only in the directory
      tree.    They aren't supported in the tree view.

      FFFF1111 ((((HHHHeeeellllpppp)))).... Invoke the    help viewer and    show this section.

      EEEEsssscccc,,,, FFFF11110000.... Exit the directory tree. Do    not change the
      directory.

      The mouse is supported. A double-click behaves like Enter.
      See also the section on mouse    support.

     FFFFiiiinnnndddd FFFFiiiilllleeee
      The Find File    feature    first asks for the start directory for
      the search and the filename to be searched for. By pressing
      the Tree button you can select the start directory from the
      directory tree figure.

      The contents field accepts regular expressions similar to
      egrep(1). That means you have    to escape characters with a
      special meaning to egrep with    "\", e.g. if you search    for
      "strcmp (" you will have to input "strcmp \("    (without the
      double quotes).

      You can start    the search by pressing the Ok button.  During



     Page 17                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      the search you can stop from the Stop    button and continue
      from the Start button.

      You can browse the filelist with the up and down arrow keys.
      The Chdir button will    change to the directory    of the
      currently selected file. The Again button will ask for the
      parameters for a new search. The Quit    button quits the
      search operation. The    Panelize button    will place the found
      files    to the current directory panel so that you can do
      additional operations    on them    (view, copy, move, delete and
      so on). After    panelizing you can press C-r to    return to the
      normal file listing.

      It is    possible to have a list    of directories that the    Find
      File command should skip during the search (for example, you
      may want to avoid searches on    a CDROM    or on a    NFS directory
      that is mounted across a slow    link).

      Directories to be skipped should be set on the variable
      ffffiiiinnnndddd____iiiiggggnnnnoooorrrreeee____ddddiiiirrrrssss in the MMMMiiiisssscccc section of your ~/.mc/ini file.

      Directory components should be separated with    a colon, here
      is an    example:

      [Misc]
      find_ignore_dirs=/cdrom:/nfs/wuarchive:/afs

      You may consider using the External panelize command for
      some operations. Find    file command is    for simple queries
      only,    while using External panelize you can do as mysterious
      searches as you would    like.

     EEEExxxxtttteeeerrrrnnnnaaaallll ppppaaaannnneeeelllliiiizzzzeeee
      The External panelize    allows you to execute an external
      program, and make the    output of that program the contents of
      the current panel.

      For example, if you want to manipulate in one    of the panels
      all the symbolic links in the    current    directory, you can use
      external panelization    to run the following command:

      find . -type l -print
      Upon command completion, the directory contents of the panel
      will no longer be the    directory listing of the current
      directory, but all the files that are    symbolic links.

      If you want to panelize all of the files that    have been
      downloaded from your ftp server, you can use this awk
      command to extract the file name from    the transfer log
      files:

      awk '$9 ~! /incoming/    { print    $9 }' <    /usr/adm/xferlog



     Page 18                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      You may want to save often used panelize commands under a
      descriptive name, so that you    can recall them    quickly. You
      do this by typing the    command    on the input line and pressing
      Add new button. Then you enter a name    under which you    want
      the command to be saved. Next    time, you just choose that
      command from the list    and do not have    to type    it again.

     HHHHoooottttlllliiiisssstttt
      The Directory    hotlist    command    shows the labels of the
      directories in the directory hotlist.    The Midnight Commander
      will change to the directory corresponding to    the selected
      label. From the hotlist dialog, you can remove already
      created label/directory pairs    and add    new one. For adding
      you may want to use a    standalone Add to hotlist command (C-x
      h), which adds the current directory into the    directory
      hotlist, as well. The    user is    prompted for a label for the
      directory.

      This makes cd    to often used directories faster. You may
      consider using the CDPATH variable as    described in internal
      cd command description.

     EEEExxxxtttteeeennnnssssiiiioooonnnn FFFFiiiilllleeee    EEEEddddiiiitttt
      This will invoke your    editor on the file ~/.mc/ext. The
      format of this file is as follows (the format    has changed
      with version 3.0):

      All lines starting with # or empty lines are thrown away.

      Lines    starting in the    first column should have following
      format:

      _k_e_y_w_o_r_d/_d_e_s_c_N_L, i.e. everything after    _k_e_y_w_o_r_d/ until new
      line is _d_e_s_c

      keyword can be:

      _s_h_e_l_l

           (desc is    then any extension (no wildcards), i.e.
           matches all the files *desc . Example: .tar matches
           *.tar)

      _r_e_g_e_x

           (desc is    a regular expression)

      _t_y_p_e

           (file matches this if `file %f` matches regular
           expression desc (the filename: part from    `file %f` is
           removed))



     Page 19                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      _d_e_f_a_u_l_t

           (matches    any file no matter what    desc is)

      Other    lines should start with    a space    or tab and should be
      of the format:

      _k_e_y_w_o_r_d=_c_o_m_m_a_n_d_N_L (with no spaces around =), where _k_e_y_w_o_r_d
      should be:

      _O_p_e_n (if the user presses Enter or doubleclicks it), _V_i_e_w
      (F3),    _E_d_i_t (F4), _D_r_o_p    (user drops some files on it) or any
      other    user defined name (those will be listed    in the
      extension dependent pop-up menu). _I_c_o_n name is reserved for
      future use by    mc.

      _c_o_m_m_a_n_d is any one-line shell    command, with the simple macro
      substitution.

      Target are evaluated from top    to bottom (order is thus
      important).  If some actions are missing, search continues
      as if    this target didn't match (i.e. if a file matches the
      first    and second entry and View action is missing in the
      first    one, then on pressing F3 the View action from the
      second entry will be used. default should catch all the
      actions.

     BBBBaaaacccckkkkggggrrrroooouuuunnnndddd jjjjoooobbbbssss
      This lets you    control    the state of any background Midnight
      Commander process (only copy and move    files operations can
      be done in the background).  You can stop, restart and kill
      a background job from    here.

     MMMMeeeennnnuuuu FFFFiiiilllleeee EEEEddddiiiitttt
      The user menu    is a menu of useful actions that can be
      customized by    the user. When you access the user menu, the
      file .mc.menu    from the current directory is used if it
      exists, but only if it is owned by user or root and is not
      world-writable.  If no such file found, ~/.mc/menu is    tried
      in the same way, and otherwise mc uses the default system-
      wide menu /usr/freeware/lib/mc/mc.menu.

      The format of    the menu file is very simple. Lines that start
      with anything    but space or tab are considered    entries    for
      the menu (in order to    be able    to use it like a hot key, the
      first    character should be a letter). All the lines that
      start    with a space or    a tab are the commands that will be
      executed when    the entry is selected.

      When an option is selected all the command lines of the
      option are copied to a temporary file    in the temporary
      directory (usually /usr/tmp) and then    that file is executed.



     Page 20                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      This allows the user to put normal shell constructs in the
      menus. Also simple macro substitution    takes place before
      executing the    menu code. For more information, see macro
      substitution.

      Here is a sample mc.menu file:

      A    Dump the    currently selected file
           od -c %f

      B    Edit a bug report and send it to    root
           vi /tmp/mail.$$
           mail -s "Midnight Commander bug"    root < /tmp/mail.$$

      M    Read mail
           emacs -f    rmail

      N    Read Usenet news
           emacs -f    gnus

      H    Call the    info hypertext browser
           info

      J    Copy current directory to other panel recursively
           tar cf -    . | (cd    %D && tar xvpf -)

      K    Make a release of the current subdirectory
           echo -n "Name of    distribution file: "
           read tar
           ln -s %d    `dirname %d`/$tar
           cd ..
           tar cvhf    ${tar}.tar $tar

      = f *.tar.gz | f *.tgz & t n
      X      Extract the contents of a compressed tar file
           tar xzvf    %f

      DDDDeeeeffffaaaauuuulllltttt CCCCoooonnnnddddiiiittttiiiioooonnnnssss

      Each menu entry may be preceded by a condition. The
      condition must start from the    first column with a '='
      character. If    the condition is true, the menu    entry will be
      the default entry.

      Condition syntax:   =    <sub-cond>
        or:              =    <sub-cond> | <sub-cond>    ...
        or:              =    <sub-cond> & <sub-cond>    ...

      Sub-condition    is one of following:

        f <pattern>          current file matching pattern?
        F <pattern>          other file matching pattern?



     Page 21                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



        d <pattern>          current directory    matching pattern?
        D <pattern>          other directory matching pattern?
        t <type>          current file of type?
        T <type>          other file of type?
        ! <sub-cond>      negate the result    of sub-condition

      Pattern is a normal shell pattern or a regular expression,
      according to the shell patterns option. You can override the
      global value of the shell patterns option by writing
      "shell_patterns=x" on    the first line of the menu file    (where
      "x" is either    0 or 1).

      Type is one or more of the following characters:

        n  not directory
        r  regular file
        d  directory
        l  link
        c  char special
        b  block special
        f  fifo
        s  socket
        x  executable
        t  tagged

      For example 'rlf' means either regular file, link or fifo.
      The 't' type is a little special because it acts on the
      panel    instead    of the file. The condition '=t t' is true if
      there    are tagged files in the    current    panel and false    if
      not.

      If the condition starts with '=?' instead of '=' a debug
      trace    will be    shown whenever the value of the    condition is
      calculated.

      The conditions are calculated    from left to right. This means
           = f *.tar.gz | f    *.tgz &    t n
      is calculated    as
           ( (f *.tar.gz) |    (f *.tgz) ) & (t n)

      Here is a sample of the use of conditions:

      = f *.tar.gz | f *.tgz & t n
      L    List the    contents of a compressed tar-archive
           gzip -cd    %f | tar xvf -

      AAAAddddddddiiiittttiiiioooonnnn CCCCoooonnnnddddiiiittttiiiioooonnnnssss

      If the condition begins with '+' (or '+?') instead of    '='
      (or '=?') it is an addition condition. If the    condition is
      true the menu    entry will be included in the menu. If the
      condition is false the menu entry will not be    included in



     Page 22                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      the menu.

      You can combine default and addition conditions by starting
      condition with '+=' or '=+' (or '+=?'    or '=+?' if you    want
      debug    trace).    If you want to use two different conditions,
      one for adding and another for defaulting, you can precede a
      menu entry with two condition    lines, one starting with '+'
      and another starting with '='.

      Comments are started with '#'. The additional    comment    lines
      must start with '#', space or    tab.

       OOOOppppttttiiiioooonnnnssss MMMMeeeennnnuuuu
      The Configuration command pops up a dialog from which    you
      can change most of settings of the Midnight Commander.

      The Display bits command pops    up a dialog from which you may
      select which characters is your terminal able    to display.

      The Confirmation command pops    up a dialog from which you
      specify which    actions    you want to confirm.

      The Learn keys command pops up a dialog from which you test
      some keys which are not working on some terminals and    you
      may fix them.

      The Virtual FS command pops up a dialog from which you
      specify some VFS related options.

      The Layout command pops up a dialog from which you specify a
      bunch    of options how mc looks    like on    the screen.

      The Save setup command saves the current settings of the
      Left,    Right and Options menus. A small number    of other
      settings is saved, too.

     CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
      The program has some options that may    be toggled on and off
      from the Configuration dialog. Options are enabled if    they
      have an asterisk or "x" in front of them. These options are
      divided into three groups:  Screen Colors, Panel Options and
      Other    Options.

      SSSSccccrrrreeeeeeeennnn CCCCoooolllloooorrrrssss

      You can select whether your display supports color or    not.
      Normally this    information is in the terminfo database. If
      you want to know how to change individual colors see the
      section on Colors.

      PPPPaaaannnneeeellll    OOOOppppttttiiiioooonnnnssss




     Page 23                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      _S_h_o_w _B_a_c_k_u_p _F_i_l_e_s. By    default    the Midnight Commander doesn't
      show files ending in '~' (like GNU's ls option -B).

      _S_h_o_w _H_i_d_d_e_n _F_i_l_e_s. By    default    the Midnight Commander will
      show all files that start with a dot (like ls    -a).

      _M_a_r_k _m_o_v_e_s _d_o_w_n. By default when you mark a file (with
      either C-t or    the Insert key)    the selection bar will move
      down.

      _S_h_o_w _M_i_n_i-_S_t_a_t_u_s. If enabled,    show one line of status
      information at the bottom of the panels about    the currently
      selected item.

      _M_i_x _a_l_l _f_i_l_e_s. When this option is enabled, all files    and
      directories are shown    mixed together.    If the option is off,
      directories (and links to directories) are shown at the
      beginning of the listing, and    other files afterwards.

      _F_a_s_t _d_i_r_e_c_t_o_r_y _r_e_l_o_a_d. This option is    off by default.    If you
      activate the fast reload, the    Midnight Commander will    use a
      trick    to determine if    the directory contents have changed.
      The trick is to reload the directory only if the i-node of
      the directory    has changed; this means    that reloads only
      happen when files are    created    or deleted. If what changes is
      the i-node for a file    in the directory (file size changes,
      mode or owner    changes, etc) the display is not updated. In
      these    cases, if you have the option on, you have to rescan
      the directory    manually (with C-r).

      OOOOtttthhhheeeerrrr    OOOOppppttttiiiioooonnnnssss

      _V_e_r_b_o_s_e _o_p_e_r_a_t_i_o_n. This toggles whether the file Copy,
      Rename and Delete operations are verbose (i.e., display a
      dialog box for each operation). If you have a    slow terminal,
      you may wish to disable the verbose operation. It is
      automatically    turned off if the speed    of your    terminal is
      less than 9600 bps.

      _P_a_u_s_e    _a_f_t_e_r _r_u_n. After executing your    commands, the Midnight
      Commander can    pause, so that you can examine the output of
      the command.    There are three    possible settings for this
      variable:

           _N_e_v_e_r Means that    you do not want    to see the output of
           your command.  If you are using the Linux or SCO
           console or an xterm, you    will be    able to    see the    output
           of the command by typing    C-o.

           _O_n _d_u_m_b _t_e_r_m_i_n_a_l_s You will get the pause    message    on
           terminals that are not capable of showing the output of
           the last    command    executed (any terminal that is not an



     Page 24                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



           xterm or    the Linux console).

           _A_l_w_a_y_s The program will pause after executing all of
           your commands.

      _S_h_e_l_l    _P_a_t_t_e_r_n_s. By default the Select, Unselect and Filter
      commands will    use shell-like regular expressions. The
      following conversions    are performed to achieve this: the '*'
      is replaced by '.*' (zero or more characters); the '?'  is
      replaced by '.' (exactly one character) and '.' by the
      literal dot. If the option is    disabled, then the regular
      expressions are the ones described in    ed(1).

      _A_u_t_o _S_a_v_e _S_e_t_u_p. If this option is enabled, when you exit
      the Midnight Commander the configurable options of the
      Midnight Commander are saved in the ~/.mc/ini    file.

      _A_u_t_o _m_e_n_u_s. If this option is    enabled, the user menu will be
      invoked at startup.  Useful for building menus for non-
      unixers.

      _U_s_e _i_n_t_e_r_n_a_l _e_d_i_t_o_r. If this option is enabled, the built-in
      file editor is used to edit files. If    the option is
      disabled, the    editor specified in the    EEEEDDDDIIIITTTTOOOORRRR environment
      variable is used.  If    no editor is specified,    vvvviiii is used.
      See the section on the internal file editor.

      _U_s_e _i_n_t_e_r_n_a_l _v_i_e_w_e_r. If this option is enabled, the built-in
      file viewer is used to view files. If    the option is
      disabled, the    pager specified    in the PPPPAAAAGGGGEEEERRRR environment
      variable is used.  If    no pager is specified, the vvvviiiieeeewwww
      command is used.  See    the section on the internal file
      viewer.

      _C_o_n_f_i_r_m _D_e_l_e_t_e. This option is toggled on by default,    and
      will cause the Midnight Commander to ask for confirmation
      when deleting    a single file.

      _C_d _f_o_l_l_o_w_s _l_i_n_k_s. This option, if set, causes    the Midnight
      Commander to follow the logical chain    of directories when
      changing current directory either in the panels, or using
      the cd command. This is the default behavior of bash.    When
      unset, the Midnight Commander    follows    the real directory
      structure, so    cd .. if you've    entered    that directory through
      a link will move you to the current directory's real parent
      and not to the directory where the link was present.

     DDDDiiiissssppppllllaaaayyyy bbbbiiiittttssss
      This is used to configure the    range of visible characters on
      the screen.  This setting may    be 7-bits if your
      terminal/curses supports only    seven output bits, ISO-8859-1
      displays all the characters in the ISO-8859-1    map and    full 8



     Page 25                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      bits is for those terminals that can display full 8 bit
      characters.

     CCCCoooonnnnffffiiiirrrrmmmmaaaattttiiiioooonnnn
      In this menu you configure the confirmation options for file
      deletion, overwriting, execution by pressing enter and
      quitting the program.

     LLLLeeeeaaaarrrrnnnn kkkkeeeeyyyyssss
      This dialog lets you test if your keys F1-F20, Home, End,
      etc. work properly on    your terminal. They often don't, since
      many terminal    databases are broken.

      You can move around with the Tab key,    with the vi moving
      keys ('h' left, 'j' down, 'k'    up and 'l' right) and after
      you press any    arrow key once (this will mark it OK), then
      you can use that key as well.

      You test them    just by    pressing each of them. As soon as you
      press    a key and the key works    properly, OK should appear
      next to the name of that key.    Once a key is marked OK    it
      starts to work as usually, e.g. F1 for the first time    will
      just check that F1 works OK, but from    that time on it    will
      show help.  The same applies to the arrow keys. Tab key
      should be working always.

      If some keys do not work properly, then you won't see    OK
      after    the key    name after you have pressed that key. You may
      then want to fix it. You do it by pressing the button    of
      that key (either by mouse or using Tab and Enter).  Then a
      red message will appear and you will be asked    to type    that
      key.    If you want to abort this, press just Esc and wait
      until    the message disappears.    Otherwise type the key you're
      asked    to type    and also wait until the    dialog disappears.

      When you finish with all the keys, you may want either to
      Save your key    fixes into your    ~/.mc/ini file into the
      [terminal:TERM] section (where TERM is the name of your
      current terminal) or to discard them.    If all your keys were
      working properly and you had not to fix any key, then    (of
      course) no saving will occur.

     VVVViiiirrrrttttuuuuaaaallll FFFFSSSS
      This option gives you    control    over the settings of the
      Virtual File System information cache.

      The Midnight Commander keeps in memory the information
      related to some of the virtual file systems to speed up the
      access to the    files in the file system.  Since the
      information that must    be kept    may be large (for example,
      compressed tar files may be kept in RAM for faster access),
      you may want to tune the parameters of the cached



     Page 26                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      information to decrease your memory usage or to maximize the
      speed    of access to frequently    used file systems.

      The Tar file system is quite clever about how    it handles tar
      files: it just loads the directory entries and when it needs
      to use the information contained in the tar file, it goes
      and grab it.

      In the wild, tar files are usually kept compressed (plain
      tar files are    species    in extinction),    and because of the
      nature of those files    (the directory entries for the tar
      files    is not there waiting for us to be loaded), the tar
      file system has two choices: load the    complete, uncompressed
      tar file into    memory or uncompress the file in the disk in a
      temporary location and then access the uncompressed file as
      a regular tar    file.

      In this dialog box you tell the Midnight Commander which
      sizes    for compressed tar files you will tolerate to load
      into your precious memory.  The default setting is set to
      one megabyte,    this means that    compressed tar files whose
      size is at most one megabyte will be loaded into core,
      otherwise a temporary    uncompressed tar file will be created
      to access the    contents (all of this is transparent to    the
      user).

      The program will let you add a suffix    to specify the units
      of the number    you typed in, use 'k' for kilobyte and 'm' for
      megabyte.  Our routine does not accept floating point
      numbers, so you can't    use ".5    m" to specify 512 kilobytes,
      you will have    to use "512 k" instead.

      Now, since we    all love to browse files and tar files all
      over the disk, it's common that you will leave a tar file
      and the re-enter it later.  Since uncompression is slow, the
      Midnight Commander will cache    the information    in memory for
      a limited amount of time, after you hit the timeout, all of
      the memory resources associated with the file    system will be
      freed.  The default timeout is set to    one minute.

     LLLLaaaayyyyoooouuuutttt
      The layout dialog gives you a    possibility to change the
      general layout of screen. You    can specify whether the
      menubar, the command prompt, the hintbar and the function
      keybar are visible. On the Linux or SCO console you can
      specify how many lines are shown in the output window.

      The rest of the screen area is used for the two directory
      panels. You can specify whether the area is split to the
      panels in vertical or    horizontal direction. The split    can be
      equal    or you can specify an unequal split.




     Page 27                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



     SSSSaaaavvvveeee SSSSeeeettttuuuupppp
      At startup the Midnight Commander will try to    load
      initialization information from the ~/.mc/ini    file. If this
      file doesn't exist, it will load the information from    the
      system-wide configuration file, located in
      /usr/freeware/lib/mc/mc.ini. If the system-wide
      configuration    file doesn't exist, MC uses the    default
      settings.

      The _S_a_v_e _S_e_t_u_p command creates the ~/.mc/ini file by saving
      the current settings of the Left, Right and Options menus.

      If you activate the _a_u_t_o _s_a_v_e    _s_e_t_u_p option, MC will always
      save the current settings when exiting.

      There    also exist settings which can't    be changed from    the
      menus. To change these settings you have to edit the setup
      file with your favorite editor. See the section on Special
      Settings for more information.


     EEEExxxxeeeeccccuuuuttttiiiinnnngggg ooooppppeeeerrrraaaattttiiiinnnngggg ssssyyyysssstttteeeemmmm    ccccoooommmmmmmmaaaannnnddddssss
      You may execute commands by typing them directly in the
      Midnight Commander's input line, or by selecting the program
      you want to execute with the selection bar in    one of the
      panels and hitting Enter.

      If you press Enter over a file that is not executable, the
      Midnight Commander checks the    extension of the selected file
      against the extensions in the    Extensions File.  If a match
      is found then    the code associated with that extension    is
      executed. A very simple macro    expansion takes    place before
      executing the    command.

       TTTThhhheeee ccccdddd iiiinnnntttteeeerrrrnnnnaaaallll ccccoooommmmmmmmaaaannnndddd
      The _c_d command is interpreted    by the Midnight    Commander, it
      is not passed    to the command shell for execution.  Thus it
      may not handle all of    the nice macro expansion and
      substitution that your shell does, although it does some of
      them:

      _T_i_l_d_e    _s_u_b_s_t_i_t_u_t_i_o_n The (~) will be substituted with your
      home directory, if you append    a username after the tilde,
      then it will be substituted with the login directory of the
      the specified    user.

      For example, ~guest is the home directory for    the user
      guest, while ~/guest is the directory    guest in your home
      directory.

      _P_r_e_v_i_o_u_s _d_i_r_e_c_t_o_r_y You can jump to the directory you were
      previously by    using the special directory name '-' like



     Page 28                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      this:     ccccdddd ----

      _C_D_P_A_T_H _d_i_r_e_c_t_o_r_i_e_s If    the directory specified    to the ccccdddd
      command is not in the    current    directory, then    The Midnight
      Commander uses the value in the environment variable CCCCDDDDPPPPAAAATTTTHHHH
      to search for    the directory in any of    the named directories.

      For example you could    set your CCCCDDDDPPPPAAAATTTTHHHH    variable to
      ~/src:/usr/src, allowing you to change your directory    to any
      of the directories inside the    ~/src and /usr/src
      directories, from any    place in the file system by using it's
      relative name    (for example cd    linux could take you to
      /usr/src/linux).

       MMMMaaaaccccrrrroooo SSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnn
      When accessing a user    menu, or executing an extension
      dependent command, or    running    a command from the command
      line input, a    simple macro substitution takes    place.

      The macros are:

      %_f

           The current file    name.

      %_d

           The current directory name.

      %_F

           The current file    in the unselected panel.

      %_D

           The directory name of the unselected panel.

      %_t

           The currently tagged files.

      %_T

           The tagged files    in the unselected panel.

      %_u and %_U

           Similar to the %t and %T    macros,    but in addition    the
           files are untagged. You can use this macro only once
           per menu    file entry or extension    file entry, because
           next time there will be no tagged files.




     Page 29                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      %_s and %_S

           The selected files: The tagged files if there are any.
           Otherwise the current file.

      %_q

           Dropped files. In all places except in the Drop action
           of the mc.ext file, this    will become a null string, in
           the Drop    action it will be replaced with    a space
           separated list of files that were dropped on the    file.

      %_c_d

           This is a special macro that is used to change the
           current directory to the    directory specified in front
           of it.  This is used primarily as an interface to the
           Virtual File System.

      %_v_i_e_w

           This macro is used to invoke the    internal viewer.  This
           macro can be used alone,    or with    arguments.  If you
           pass any    arguments to this macro, they should be
           enclosed    in brackets.

           The arguments are: _a_s_c_i_i    to force the viewer into ascii
           mode; _h_e_x to force the viewer into hex mode; _n_r_o_f_f to
           tell the    viewer that it should interpret    the bold and
           underline sequences of nroff; _u_n_f_o_r_m_a_t_e_d    to tell    the
           viewer to not interpret nroff commands for making the
           text bold or underlined.

      %%

           The % character

      %{_s_o_m_e _t_e_x_t}

           Prompt for the substitution. An input box is shown and
           the text    inside the braces is used as a prompt. The
           macro is    substituted by the text    typed by the user. The
           user can    press ESC or F10 to cancel. This macro doesn't
           work on the command line    yet.

       TTTThhhheeee ssssuuuubbbbsssshhhheeeellllllll ssssuuuuppppppppoooorrrrtttt
      The subshell support is a compile time option, that works
      with the shells: bash, tcsh and zsh.

      When the subshell code is activated the Midnight Commander
      will spawn a concurrent copy of your shell (the one defined
      in the SSSSHHHHEEEELLLLLLLL variable    and if it is not defined, then the one



     Page 30                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      in the /etc/passwd file) and run it in a pseudo terminal,
      instead of invoking a    new shell each time you    execute    a
      command, the command will be passed to the subshell as if
      you had typed    it.  This also allows you to change the
      environment variables, use shell functions and define
      aliases that are valid until you quit    the Midnight
      Commander.

      If you are using bbbbaaaasssshhhh    you can    specify    startup    commands for
      the subshell in your ~/.mc/bashrc file and special keyboard
      maps in the ~/.mc/inputrc file.  ttttccccsssshhhh    users may specify
      startup commands in the ~/.mc/tcshrc file.

      When the subshell code is used, you can suspend applications
      at any time with the sequence    C-o and    jump back to the
      Midnight Commander, if you interrupt an application, you
      will not be able to run other    external commands until    you
      quit the application you interrupted.

      An extra added feature of using the subshell is that the
      prompt displayed by the Midnight Commander is    the same
      prompt that you are currently    using in your shell.

      The OPTIONS section has more information on how you can
      control the subshell code.

       CCCCoooonnnnttttrrrroooolllllllliiiinnnngggg MMMMiiiiddddnnnniiiigggghhhhtttt CCCCoooommmmmmmmaaaannnnddddeeeerrrr
      The Midnight Commander defines an environment    variable
      MC_CONTROL_FILE. The commands    executed by MC may give
      instructions to MC by    writing    to the file specified by this
      variable.  This is only available if you compiled your copy
      of the Midnight Commander with the WANT_PARSE    option.

      The following    instructions are supported.

      clear_tags          Clear all    tags.
      tag <filename>      Tag specified file.
      untag    <filename>    Untag specified file.
      select <filename>   Move pointer to file.
      change_panel          Switch between panels.
      cd <path>     Change    directory.

      If the first letter of the instruction is in lower case it
      operates on the current panel. If the    letter is in upper
      case the instruction operates    on the other panel. The
      additional letters must be in    lower case. Instructions must
      be separated by exactly one space, tab or newline. The
      instructions don't work in the Info, Tree and    Quick views.
      The first error causes the rest to be    ignored.

     CCCChhhhmmmmoooodddd
      The Chmod window is used to change the attribute bits    in a



     Page 31                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      group    of files and directories.  It can be invoked with the
      C-x c    key combination.

      The Chmod window has two parts - _P_e_r_m_i_s_s_i_o_n_s and _F_i_l_e

      In the File section are displayed the    name of    the file or
      directory and    its permissions    in octal form, as well as its
      owner    and group.

      In the Permissions section there is a    set of check buttons
      which    correspond to the file attribute bits.    As you change
      the attribute    bits, you can see the octal value change in
      the File section.

      To move between the widgets (buttons and check buttons) use
      the _a_r_r_o_w _k_e_y_s or the    _T_a_b key.  To change the    state of the
      check    buttons    or to select a button use _S_p_a_c_e. You can also
      use the hotkeys on the buttons to quickly activate that
      selection (they are the highlit letters on the buttons).

      To set the attribute bits, use the Enter key.

      When working with a group of files or    directories, you just
      click    on the bits you    want to    set or clear.  Once you    have
      selected the bits you    want to    change,    you select one of the
      action buttons (Set marked or    Clear marked).

      Finally, to set the attributes exactly to those specified,
      you can use the [[[[SSSSeeeetttt aaaallllllll]]]] button, which will act on all the
      tagged files.

      [[[[MMMMaaaarrrrkkkkeeeedddd aaaallllllll]]]] set only    marked attributes to all selected
      files

      [[[[SSSSeeeetttt mmmmaaaarrrrkkkkeeeedddd]]]] set marked bits in attributes of    all selected
      files

      [[[[CCCClllleeeeaaaannnn mmmmaaaarrrrkkkkeeeedddd]]]] clear marked bits in attributes of all
      selected files

      [[[[SSSSeeeetttt]]]]    set the    attributes of one file

      [[[[CCCCaaaannnncccceeeellll]]]] cancel the Chmod command

     CCCChhhhoooowwwwnnnn
      The Chown command is used to change the owner/group of a
      file.    The hot    key for    this command is    C-x o.

     FFFFiiiilllleeee OOOOppppeeeerrrraaaattttiiiioooonnnnssss
      When you copy, move or delete    files the Midnight Commander
      shows    the file operations dialog. It shows the files
      currently being operated on and there    are at most three



     Page 32                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      progress bars. The file bar tells how    big part of the
      current file has been    copied so far. The count bar tells how
      many of tagged files have been handled so far. The bytes bar
      tells    how big    part of    total size of the tagged files has
      been handled so far. If the verbose option is    off the    file
      and bytes bars are not shown.

      There    are two    buttons    at the bottom of the dialog. Pressing
      the Skip button will skip the    rest of    the current file.
      Pressing the Abort button will abort the whole operation,
      the rest of the files    are skipped.

      There    are three other    dialogs    which you can run into during
      the file operations.

      The error dialog informs about error conditions and has
      three    choices. Normally you select either the    Skip button to
      skip the file    or the Abort button to abort the operation
      altogether. You can also select the Retry button if you
      fixed    the problem from another terminal.

      The replace dialog is    shown when you attempt to copy or move
      a file on the    top of an existing file. The dialog shows the
      dates    and sizes of the both files. Press the Yes button to
      overwrite the    file, the No button to skip the    file, the alL
      button to overwrite all the files, the nonE button to    never
      overwrite and    the Update button to overwrite if the source
      file is newer    than the target    file. You can abort the    whole
      operation by pressing    the Abort button.

      The recursive    delete dialog is shown when you    try to delete
      a directory which is not empty. Press    the Yes    button to
      delete the directory recursively, the    No button to skip the
      directory, the alL button to delete all the directories and
      the nonE button to skip all the non-empty directories. You
      can abort the    whole operation    by pressing the    Abort button.
      If you selected the Yes or alL button    you will be asked for
      a confirmation. Type "yes" only if you are really sure you
      want to do the recursive delete.

      If you have tagged files and perform an operation on them
      only the files on which the operation    succeeded are
      untagged. Failed and skipped files are left tagged.

     MMMMaaaasssskkkk CCCCooooppppyyyy////RRRReeeennnnaaaammmmeeee
      The copy/move    operations lets    you translate the names    of
      files    in an easy way.    To do it, you have to specify the
      correct source mask and usually in the trailing part of the
      destination specify some wildcards.  All the files matching
      the source mask are copied/renamed according to the target
      mask.    If there are tagged files, only    the tagged files
      matching the source mask are renamed.



     Page 33                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      There    are other option which you can set:

      Follow links tells whether make the symlinks and hardlinks
      in the source    directory (recursively in subdirectories) new
      links    in the target directory    or whether would you like to
      copy their content.

      Dive into subdirs tells what to do if    in the target
      directory exists a directory with the    same name as the
      file/directory being copied. The default action is to    copy
      it's content into that directory, by enabling    this you can
      copy the source directory into that directory. Perhaps an
      example will help:

      You want to copy content of a    directory foo to /bla/foo,
      which    is an already existing directory. Normally (when Dive
      is not set), mc would    copy it    exactly    into /bla/foo. By
      enabling this    option you will    copy the content into
      /bla/foo/foo,    because    the directory already exists.

      Preserve attributes tells whether to preserve    the original
      files' permissions, timestamps and if    you are    root whether
      to preserve the original files' UID and GID. If this option
      is not set the current value of the umask will be respected.

      UUUUsssseeee sssshhhheeeellllllll ppppaaaatttttttteeeerrrrnnnnssss oooonnnn

      When the shell patterns option is on you can use the '*' and
      '?'  wildcards in the    source mask. They work like they do in
      the shell. In    the target mask    only the '*' and '\<digit>'
      wildcards are    allowed. The first '*' wildcard    in the target
      mask corresponds to the first    wildcard group in the source
      mask,    the second '*' corresponds to the second group and so
      on. The '\1' wildcard    corresponds to the first wildcard
      group    in the source mask, the    '\2' wildcard corresponds to
      the second group and so on all the way up to '\9'. The '\0'
      wildcard is the whole    filename of the    source file.

      Two examples:

      If the source    mask is    "*.tar.gz", the    destination is
      "/bla/*.tgz" and the file to be copied is "foo.tar.gz", the
      copy will be "foo.tgz" in "/bla".

      Let's    suppose    you want to swap basename and extension    so
      that "file.c"    will become "c.file" and so on.    The source
      mask for this    is "*.*" and the destination is    "\2.\1".

      UUUUsssseeee sssshhhheeeellllllll ppppaaaatttttttteeeerrrrnnnnssss ooooffffffff

      When the shell patterns option is off    the MC doesn't do
      automatic grouping anymore. You must use '\(...\)'



     Page 34                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      expressions in the source mask to specify meaning for    the
      wildcards in the target mask.    This is    more flexible but also
      requires more    typing.    Otherwise target masks are similar to
      the situation    when the shell patterns    option is on.

      Two examples:

      If the source    mask is    "^\(.*\)\.tar\.gz$", the destination
      is "/bla/*.tgz" and the file to be copied is "foo.tar.gz",
      the copy will    be "/bla/foo.tgz".

      Let's    suppose    you want to swap basename and extension    so
      that "file.c"    will become "c.file" and so on.    The source
      mask for this    is "^\(.*\)\.\(.*\)$" and the destination is
      "\2.\1".

      CCCCaaaasssseeee CCCCoooonnnnvvvveeeerrrrssssiiiioooonnnnssss

      You can also change the case of the filenames. If you    use
      '\u' or uppercase or lowercase correspondingly.

      If you use '\U' or '\L' in the target    mask the next
      characters will be converted to uppercase or lowercase
      correspondingly up to    the next

      The '\u' and '\l' are    stronger than '\U' and '\L'.

      For example, if the source mask is '*' (shell    patterns on)
      or '^\(.*\)$'    (shell patterns    off) and the target mask is
      '\L\u*' the file names will be converted to have initial
      upper    case and otherwise lower case.

      You can also use '\' as a quote character. For example, '\\'
      is a backslash and '\*' is an    asterisk.

     IIIInnnntttteeeerrrrnnnnaaaallll FFFFiiiilllleeee VVVViiiieeeewwwweeeerrrr
      The internal file viewer provides two    display    modes: ASCII
      and hex.  To toggle between modes, use the F4    key.  If you
      have the GNU gzip program installed, it will be used to
      automatically    decompress the files on    demand.

      The viewer will try to use the best method provided by your
      system or the    file type to display the information.  The
      internal file    viewer will interpret some string sequences to
      set the bold and underline attributes, thus making a pretty
      display of your files.

      When in hex mode, the    search function    accepts    text in    quotes
      as well as hexadecimal constants.

      You can mix quoted text with constants like this: "String"
      0xFE 0xBB "more text".  Text between constants and quoted



     Page 35                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      text is just ignored.

      Some internal    details    about the viewer: On systems that
      provide the mmap(2) system call, the program maps the    file
      instead of loading it; if the    system does not    provide    the
      mmap(2) system call or the file matches an action that
      requires a filter, then the viewer will use it's growing
      buffers, thus    loading    only those parts of the    file that you
      actually access (this    includes compressed files).

      Here is a listing of the actions associated with each    key
      that the Midnight Commander handles in the internal file
      viewer.

      FFFF1111 Invoke the    builtin    hypertext help viewer.

      FFFF2222 Toggle the    wrap mode.

      FFFF4444 Toggle the    hex mode.

      FFFF5555 Goto line.     This will prompt you for a line number    and
      will display that line.

      FFFF6666,,,, ////.... Regular expression search.

      ????,,,, Reverse regular expression    search.

      FFFF7777 Normal search / hex mode search.

      CCCC----ssss.... Start normal search if there was    no previous search
      expression else find next match.

      CCCC----rrrr.... Start reverse search if there was no previous search
      expression else find next match.

      nnnn.... Find next match.

      FFFF8888 Toggle Raw/Parsed mode: This will show the    file as    found
      on disk or if    a processing filter has    been specified in the
      mc.ext file, then the    output from the    filter.    Current    mode
      is always the    other than written on the button label,    since
      on the button    is the mode which you enter by that key.

      FFFF9999 Toggle the    format/unformat    mode: when format mode is on
      the viewer will interpret some string    sequences to show bold
      and underline    with different colors. Also, on    button label
      is the other mode than current.

      FFFF11110000,,,, EEEEsssscccc.... Exit the internal file viewer.

      nnnneeeexxxxtttt----ppppaaaaggggeeee,,,, ssssppppaaaacccceeee,,,, CCCC----vvvv.... Scroll    one page forward.




     Page 36                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      pppprrrreeeevvvv----ppppaaaaggggeeee,,,, MMMM----vvvv,,,, CCCC----bbbb,,,, bbbbaaaacccckkkkssssppppaaaacccceeee.... Scroll one page backward.

      ddddoooowwwwnnnn----kkkkeeeeyyyy Scroll one line forward.

      uuuupppp----kkkkeeeeyyyy Scroll    one line backward.

      CCCC----llll Refresh the screen.

      !!!! Spawn a shell in the currently working directory.

      [[[[nnnn]]]] mmmm    Set the    mark n.

      [[[[nnnn]]]] rrrr    Jump to    the mark n.

      CCCC----ffff Jump to the next file.

      CCCC----bbbb Jump to the previous file.

      MMMM----rrrr Toggle the ruler.

      It's possible    to instruct the    file viewer how    to display a
      file,    look at    the Extension File Edit    section

     IIIInnnntttteeeerrrrnnnnaaaallll FFFFiiiilllleeee EEEEddddiiiittttoooorrrr
      The internal file editor provides most of the    features of
      common full screen editors. It is invoked using FFFF4444 provided
      the _u_s_e__i_n_t_e_r_n_a_l__e_d_i_t    option is set in the initialization
      file.    It has an extensible file size limit of    sixteen
      megabytes and    edits binary files flawlessly.

      The features it presently supports are: Block    copy, move,
      delete, cut, paste; _k_e_y _f_o_r _k_e_y _u_n_d_o ; pull-down menus; file
      insertion; macro definition; regular expression search and
      replace (and our own scanf-printf search and replace);
      shift-arrow MSW-MAC text highlighting    (for the linux console
      only); insert-overwrite toggle; and an option    to pipe    text
      blocks through shell commands    like indent.

      The editor is    very easy to use and requires no tutoring.  To
      see what keys    do what, just consult the appropriate pull-
      down menu. Other keys    are: Shift movement keys do text
      highlighting.    CCCCttttrrrrllll----IIIInnnnssss copies    to the file ccccoooooooolllleeeeddddiiiitttt....cccclllliiiipppp aaaannnndddd
      SSSShhhhiiiifffftttt----IIIInnnnssss pastes from    cooledit.clip.    SSSShhhhiiiifffftttt----DDDDeeeellll cuts to
      ccccoooooooolllleeeeddddiiiitttt....cccclllliiiipppp,,,, and CCCCttttrrrrllll----DDDDeeeellll deletes highlighted text.    The
      completion key also does a Return with an automatic indent.
      Mouse    highlighting also works, and you can override the
      mouse    as usual by holding down the shift key while dragging
      the mouse to let normal terminal mouse highlighting work.

      To define a macro, press CCCCttttrrrrllll----RRRR
       and then type out the key strokes you want to be executed.
      Press    CCCCttttrrrrllll----RRRR



     Page 37                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



       again when finished.    You can    then assign the    macro to any
      key you like by pressing that    key. The macro is executed
      when you press CCCCttttrrrrllll----AAAA    aaaannnndddd tttthhhheeeennnn tttthhhheeee aaaassssssssiiiiggggnnnneeeedddd kkkkeeeeyyyy....  you    press
      Meta,    Ctrl, or Esc and the assigned key, provided that the
      key is not used for any other    function. Once defined,    the
      macro    commands go into the file cccceeeeddddiiiitttt////ccccoooooooolllleeeeddddiiiitttt....mmmmaaaaccccrrrroooossss
       in your home    directory. You can delete a macro by deleting
      the appropriate line in this file.

      FFFF11119999 wwwwiiiillllllll ffffoooorrrrmmmmaaaatttt CCCC ccccooooddddeeee wwwwhhhheeeennnn to work, make an executable file
      called cccceeeeddddiiiitttt////eeeeddddiiiitttt....iiiinnnnddddeeeennnntttt....rrrrcccc in your home directory
      containing the following:

      #!/bin/sh
      /usr/bin/indent -kr -pcs ~/cedit/cooledit.block >& /dev/null
      cat /dev/null    > ~/cedit/cooledit.error

      You can use scanf search and replace to search and replace a
      C format string. First take a    look at    the ssssssssccccaaaannnnffff and sssspppprrrriiiinnnnttttffff
      mmmmaaaannnn ppppaaaaggggeeeessss ttttoooo sssseeeeeeee wwwwhhhhaaaatttt    is and how it works. An    example    is as
      follows: Suppose you want to replace all occurences of say,
      an open bracket, three comma seperated numbers, and a    close
      bracket, with    the word _a_p_p_l_e_s, the third number, the word
      _o_r_a_n_g_e_s and then the second number, I    would fill in the
      Replace dialog box as    follows:

       Enter search    string
      (%d,%d,%d)
       Enter replace string
      apples %d oranges %d
       Enter replacement argument order
      3,2

      The last line    specifies that the third and then the second
      number are to    be used    in place of the    first and second.

      It is    advisable to use this feature with Prompt on replace
      on, because a    match is thought to be found whenever the
      number of arguments found matches the    number given, which is
      not always a real match. Scanf also treats whitespace    as
      being    elastic.  Note that the    scanf format % is very useful
      for scanning strings,    and whitespace.

      The editor also displays non-us characters (160+). When
      editing binary files,    you should set ddddiiiissssppppllllaaaayyyy bbbbiiiittttssss to 7 bits
      in the options menu to keep the spacing clean.

      See also the file RRRREEEEAAAADDDDMMMMEEEE....eeeeddddiiiitttt    in the source tree for some
      more info.

     CCCCoooommmmpppplllleeeettttiiiioooonnnn
      Let the Midnight Commander type for you.



     Page 38                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      Attempt to perform completion    on the text before current
      position. MC attempts    completion treating the    text as
      variable (if the text    begins with $$$$ ), username (if the text
      begins with ~~~~    ), hostname (if    the text begins    with @@@@ ) or
      command (if you are on the command line in the position
      where    you might type a command, possible completions then
      include shell    reserved words and shell builtin commands as
      well)    in turn. If none of these produces a match, filename
      completion is    attempted.

      Filename, username, variable and hostname completion works
      on all input lines, command completion is command line
      specific.  If    the completion is ambiguous (there are more
      different possibilities), MC beeps and the following action
      depends on the setting of the    show_all_if_ambiguous variable
      in the Initialization    file. If it is nonzero,    a list of all
      possibilities    pops up    next to    the current position and you
      can select with the arrow keys and EEEEnnnntttteeeerrrr the correct entry.
      You can also type the    first letters in which the
      possibilities    differ to move to a subset of all
      possibilities    and complete as    much as    possible. If you press
      MMMM----TTTTaaaabbbb    again, only the    subset will be shown in    the listbox,
      otherwise the    first item which matches all the previous
      characters will be highlighted. As soon as there is no
      ambiguity, dialog disappears,    but you    can hide it by
      canceling keys EEEEsssscccc,,,, FFFF11110000 and left and right arrow keys. If
      show_all_if_ambiguous    is set to zero,    the dialog pops    up
      only if you press MMMM----TTTTaaaabbbb for the second time, for the first
      time MC just beeps.

     VVVViiiirrrrttttuuuuaaaallll FFFFiiiilllleeee SSSSyyyysssstttteeeemmmm
      The Midnight Commander is provided with a code layer to
      access the file system; this code layer is known as the
      virtual file system switch.  The virtual file    system switch
      allows the Midnight Commander    to manipulate files not
      located on the Unix file system.

      Currently the    Midnight Commander is packaged with five
      Virtual File Systems (VFS): the local    file system, used for
      accessing the    regular    Unix file system; the ftpfs, used to
      manipulate files on remote systems with the FTP protocol;
      the tarfs, used to manipulate    tar and    compressed tar files;
      the undelfs, used to recover deleted files on    ext2 file
      systems (the default file system for Linux systems) and
      finally the mcfs (Midnight Commander file system), a network
      based    file system.

      The VFS switch code will interpret all of the    path names
      used and will    forward    them to    the correct file system, the
      formats used for each    one of the file    systems    is described
      later    in their own section.




     Page 39                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



       FFFFTTTTPPPP FFFFiiiilllleeee    SSSSyyyysssstttteeeemmmm
      The ftpfs allows you to manipulate files on remote machines,
      to actually use it, you may try to use the panel command FTP
      link (accessible from    the menubar) or    you may    directly
      change your current directory    to it using the    cd command to
      a path name that looks like this:

      _f_t_p://[!][_u_s_e_r[:_p_a_s_s]@]_m_a_c_h_i_n_e[:_p_o_r_t][_r_e_m_o_t_e-_d_i_r]

      The, _u_s_e_r, _p_o_r_t and _r_e_m_o_t_e-_d_i_r elements are optional.     If
      you specify the _u_s_e_r element,    then the Midnight Commander
      will try to logon on the remote machine as that user,
      otherwise it will use    your login name.  The optional _p_a_s_s
      element, if present is the password used for the connection.
      This use is not recomented (nor keeping this in your
      hotlist, unless you set the appropiate permissions there,
      and then, it may not be entirely safe    anyways).

      Examples:

          ftp://ftp.nuclecu.unam.mx/linux/local
          ftp://tsx-11.mit.edu/pub/linux/packages
          ftp://!behind.firewall.edu/pub
          ftp://[e-mail]:40/pub
          ftp://miguel:xxx@server/pub

      To connect to    sites behind a firewall, you will need to use
      the prefix ftp://! (ie, with a bang character    after the
      double slash)    to make    the Midnight Commander use a proxy
      host for doing the ftp transfer.  You    can define the proxy
      host in the Virtual File System dialog box.

      Another option is to set the _f_t_p_f_s__a_l_w_a_y_s__u_s_e__p_r_o_x_y
      parameter in the initialization file.     This will configure
      the program to always    use the    proxy host.  If    this variable
      is set, the program will do two things: consult the
      /usr/freeware/lib/mc.no_proxy    file for lines containing host
      names    that are local (if the host name starts    with a dot, it
      is assumed to    be a domain) and to assume that    any hostnames
      without dots in their    names are directly accessible.

      If you are using the ftpfs code with a filtering packet
      router that does not allow you to use    the regular mode of
      opening files, you may want to force the program to use the
      passive-open mode.  To use this, set the
      ftpfs_use_passive_connections    option.

      The Midnight Commander keeps the directory listing in    a
      cache.  The cache expire time    is configurable    in the Virtual
      File System dialog box.  This    has the    funny behavior that
      even if you make changes to a    directory, they    will not be
      reflected in the directory listing until you force a cache



     Page 40                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      reload with the C-r key.  This is a feature (when you    think
      it's a bug, think about manipulating files on    the other side
      of the Atlantic with ftpfs).

       TTTTaaaarrrr FFFFiiiilllleeee    SSSSyyyysssstttteeeemmmm
      The tar file system provides you with    read-only access to
      your tar files and compressed    tar files by using the chdir
      command.  To change your directory to    a tar file, you    change
      your current directory to the    tar file by using the
      following syntax:

      _t_a_r:_f_i_l_e_n_a_m_e._t_a_r[_d_i_r-_i_n_s_i_d_e-_t_a_r]

      The mc.ext file already provides a shortcut for tar files,
      this means that usually you just point to a tar file and
      press    return to enter    into the tar file, see the Extension
      File Edit section for    details    on how this is done.

      Examples:

          tar:mc-3.0.tar.gz/mc-3.0/vfs
          tar:/ftp/GCC/gcc-2.7.0.tar

      The latter specifies the full    path of    the tar    archive.

       NNNNeeeettttwwwwoooorrrrkkkk FFFFiiiilllleeee SSSSyyyysssstttteeeemmmm
      The Midnight Commander file system is    a network base file
      system that allows you to manipulate the files in a remote
      machine as if    they were local.  To use this, the remote
      machine must be running the mcserv(8)    server program.

      To connect to    a remote machine, you just need    to chdir into
      a special directory which name is in the following format:

      _m_c:[_u_s_e_r@]_m_a_c_h_i_n_e[:_p_o_r_t][_r_e_m_o_t_e-_d_i_r]

      The, _u_s_e_r, _p_o_r_t and _r_e_m_o_t_e-_d_i_r elements are optional.     If
      you specify the _u_s_e_r element then the    Midnight Commander
      will try to logon on the remote machine as that user,
      otherwise it will use    your login name.

      The _p_o_r_t element is used when    the remote machine running on
      a special port (see the mcserv(8) manual page    for more
      information about ports); finally, if    the _r_e_m_o_t_e-_d_i_r element
      is present, your current directory on    the remote machine
      will be set to this one.

      Examples:

          mc:ftp.nuclecu.unam.mx/linux/local
          mc:[e-mail]:11321/private




     Page 41                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



       UUUUnnnnddddeeeelllleeeetttteeee    FFFFiiiilllleeee SSSSyyyysssstttteeeemmmm
      On Linux systems, if you asked configure to use the ext2fs
      undelete facilities, you will    have the undelete file system
      available.  Recovery of deleted files    is only    available on
      ext2 file systems.  The undelete file    system is just an
      interface to the ext2fs library to:  retrieve    all of the
      deleted files    names on an ext2fs and provides    and to extract
      the selected files into a regular partition.

      To use this file system, you have to chdir into the special
      file name formed by the "undel:" prefix and the file name
      where    the actual file    system resides.

      For example, to recover deleted files    on the second
      partition of the first scsi disk on Linux, you would use the
      following path name:

          undel:/dev/sda2

      It may take a    while for the undelfs to load the required
      information before you start browsing    files there.

     CCCCoooolllloooorrrrssss
      The Midnight Commander will try to detect if your terminal
      supports color using the terminal database and your terminal
      name.     Sometimes it gets confused, so    you may    force color
      mode or disable color    mode using the -c and -b flag
      respectively.

      If the program is compiled with the Slang screen manager
      instead of ncurses, it will also check the variable
      CCCCOOOOLLLLOOOORRRRTTTTEEEERRRRMMMM,,,, if    it is set, it has the same effect as the -c
      flag.

      You may specify terminals that always    force color mode by
      adding the _c_o_l_o_r__t_e_r_m_i_n_a_l_s variable to the Colors section of
      the initialization file. This    will prevent the Midnight
      Commander from trying    to detect if your terminal supports
      color. Example:
      [Colors]
      color_terminals=linux,xterm
      color_terminals=terminal-name1,terminal-name2...

      The program can be compiled with both    ncurses    and slang,
      ncurses does not provide a way to force color    mode: ncurses
      uses just the    information in the terminal database.

      The Midnight Commander provides a way    to change the default
      colors.  Currently the colors    are configured using the
      environment variable MMMMCCCC____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE or the Colors section in
      the initialization file.




     Page 42                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      In the Colors    section, the default color map is loaded from
      the _b_a_s_e__c_o_l_o_r variable.  You    can specify an alternate color
      map for a terminal by    using the terminal name    as the key in
      this section.     Example:

      [Colors]
      base_color=
      xterm=menu=magenta:marked=,magenta:markselect=,red

      The format for the color definition is:

        <keyword>=<foregroundcolor>,<backgroundcolor>:<keyword>= ...

      The colors are optional, and the keywords are: normal,
      selected, marked, markselect,    errors,    input, reverse menu,
      menusel, menuhot, menuhotsel,    gauge;    the dialog colors are:
      dnormal, dfocus, dhotnormal, dhotfocus; Help colors are:
      helpnormal, helpitalic, helpbold, helplink, helpslink;
      Viewer color is: viewunderline; Special highlighting mode:
      executable, directory, link, device, special.

      The dialog boxes use the following colors:  _d_n_o_r_m_a_l is used
      for the normal text, _d_f_o_c_u_s is the color used    for the
      currently selected component,    _d_h_o_t_n_o_r_m_a_l is the color    used
      to differentiate the hotkey color in normal components,
      whereas the _d_h_o_t_f_o_c_u_s    color is used for the highlighted
      color    in the currently selected component.

      Menus    use the    same scheme but    uses the menu, menusel,
      menuhot and menuhotsel tags instead.

      Help uses the    following colors:  _h_e_l_p_n_o_r_m_a_l is used for
      normal text, _h_e_l_p_i_t_a_l_i_c is used for text which is emphasized
      in italic in the manual page,    _h_e_l_p_b_o_l_d is used for text
      which    is emphasized in bold in the manual page, _h_e_l_p_l_i_n_k is
      used for not selected    hyperlinks and _h_e_l_p_s_l_i_n_k is used for
      selected hyperlink.

      _g_a_u_g_e    determines color of filled part    of the progress    bar
      (gauge), which shows how many    percent    of files were copied
      etc. in a graphical way.

      For file type    highlighting mode _d_i_r_e_c_t_o_r_y specifies the
      color    in which directories are shown;    _e_x_e_c_u_t_a_b_l_e for
      executable files; _l_i_n_k is used to represent links; _d_e_v_i_c_e
      for character    and block devices; _s_p_e_c_i_a_l is for special
      files, such as FIFO and IPC sockets; _c_o_r_e is for core    files
      (see also the    option hhhhiiiigggghhhhlllliiiigggghhhhtttt____mmmmooooddddeeee at the section on
      Special Settings).


      The possible colors are: black, gray,    red, brightred,    green,



     Page 43                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      brightgreen, brown, yellow, blue, brightblue,    magenta,
      brightmagenta, cyan, brightcyan, lightgray and white.

     SSSSppppeeeecccciiiiaaaallll SSSSeeeettttttttiiiinnnnggggssss
      Most of the settings of the Midnight Commander can be
      changed from the menus. However, there are a small number of
      settings which can only be changed by    editing    the setup
      file.

      These    variables may be set in    your ~/.mc/ini file:

      _c_l_e_a_r__b_e_f_o_r_e__e_x_e_c.

           By default the Midnight Commander clears    the screen
           before executing    a command. If you would    prefer to see
           the output of the command at the    bottom of the screen,
           edit your ~/mc.ini file and change the value of the
           field clear_before_exec to 0.

      _c_o_n_f_i_r_m__v_i_e_w__d_i_r.

           If you press F3 on a directory, normally    MC enters that
           directory. If this flag is set to 1, then MC will ask
           for confirmation    before changing    the directory if you
           have files tagged.

      _d_r_o_p__m_e_n_u_s.

           If this variable    is set,    when you press the F9 key, the
           pull down menus will be activated, else,    you will only
           be presented with the menu title, and you will have to
           select the entry    with the arrow keys or the first
           letter and from there select your option    in the menu.

      _f_t_p_f_s__r_e_t_r_y__s_e_c_o_n_d_s.

           This value is the number    of seconds the Midnight
           Commander will wait before attempting a reconnection to
           an ftp server that has denied the login.     If the    value
           is zero,    the the    program    will not retry the login.

      _f_t_p_f_s__u_s_e__p_a_s_s_i_v_e__c_o_n_n_e_c_t_i_o_n_s.

           This option is by off default.  This makes the ftpfs
           code use    the passive open mode for transfering files.
           This is used by people that are behind a    filtering
           packet router.  This option just    works if you are not
           using an    ftp proxy.

      _m_a_x__d_i_r_t__l_i_m_i_t.

           Specifies how many screen updates can be    skipped    at



     Page 44                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



           most in the internal file viewer.  Normally this    value
           is not significant, because the code automatically
           adjusts the number of updates to    skip according to the
           rate of incoming    keypresses. However, on    very slow
           machines    or terminals with a fast keyboard auto repeat,
           a big value can make screen updates too jumpy.

           It seems    that setting max_dirt_limit to 10 causes the
           best behavior, and that is the default value.

      _m_o_u_s_e__m_o_v_e__p_a_g_e_s.

           Controls    whenever scrolling with    the mouse is done by
           pages or    line by    line on    the panels.

      _m_o_u_s_e__m_o_v_e__p_a_g_e_s__v_i_e_w_e_r.

           Controls    if scrolling with the mouse is done by pages
           or line by line on the internal file viewer.

      _n_a_v_i_g_a_t_e__w_i_t_h__a_r_r_o_w_s.

           If this setting is turned on, then you may use the
           arrows keys to automatically chdir if the current
           selection is a subdirectory and the shell command line
           is empty.  By default, this setting is off.

      _n_i_c_e__r_o_t_a_t_i_n_g__d_a_s_h

           When on,    this flag causes the commander to show a
           rotating    dash as    a work in progress indicator.

      _o_l_d__e_s_c__m_o_d_e

           By default the Midnight Commander treats    the ESC    key as
           a key prefix (old_esc_mode=0), if you set this option
           (old_esc_mode=1), then the ESC key will act as a    prefix
           key for one second, and if no extra keys    have arrived,
           then the    ESC key    is interpreted as a cancel key (ESC
           ESC).

      _o_n_l_y__l_e_a_d_i_n_g__p_l_u_s__m_i_n_u_s

           set special treatment for '+', '-', '*' in command line
           (select,    unselect, reverse selection) only if command
           line is empty. No need to quote this characters in the
           middle of the command line. But we can not change
           selection when command line is not empty.
           _p_a_n_e_l__s_c_r_o_l_l__p_a_g_e_s

           If set (the default), panel will    scroll by half the
           display when the    cursor reaches the end or the



     Page 45                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



           beginning of the    panel, otherwise it will just scroll a
           file at a time.

      _p_r_e_s_e_r_v_e__u_i_d_g_i_d

           If this option is set (the default), when logged    in as
           root the    default    will be    to preserve the    UID and    the
           GID of files.  Some users prefer    to disable this
           option, so that's why it's configurable.

      _s_h_o_w__o_u_t_p_u_t__s_t_a_r_t_s__s_h_e_l_l

           This variable only works    if you are not using the
           subshell    support.  When you use the C-o keystroke to go
           back to the user    screen,    if this    one is set, you    will
           get a fresh shell.  Otherwise, pressing any key will
           bring you back to the Midnight Commander.

      _s_h_o_w__a_l_l__i_f__a_m_b_i_g_u_o_u_s.

           By default the Midnight Commander pops up all possible
           completions if the completion is    ambiguous if you press
           MMMM----TTTTaaaabbbb for the second time, for the first    time it    just
           completes as much as possible and in the    case of
           ambiguity beeps.    If you want to see all the possible
           completions already after the first MMMM----TTTTaaaabbbb pressing, set
           this option to 1.

      _t_o_r_b_e_n__f_j__m_o_d_e

           If this flag is set, then the home and end keys will
           work slightly different on the panels, instead of
           moving the selection to the first and last files    in the
           panels, they will act as    follows:

           The home    key will: Go up    to the middle line, if below
           it; else    go to the top line unless it is    already    on the
           top line, in this case it will go to the    first file in
           the panel.

           The end key has a similar behavior: Go down to the
           middle line, if over it;    else go    to the bottom line
           unless you already are at the bottom line, in such case
           it will move the    selection to the last file name    in the
           panel.

      _h_i_g_h_l_i_g_h_t__m_o_d_e By default all    information on panels
      displayed with the same color. If this variable is set to 1,
      then _p_e_r_m or _m_o_d_e tokens in display format get ability to
      show access rights of    the user to the    shown file.
      Appropriate triplet of reading, writing and execution    rights
      highlighted with the yellow (    _s_e_l_e_c_t_e_d ) color. In addition,



     Page 46                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      if the variable is equal to 2, then all lines    are displaying
      by the color according to their type (see Colors).
      Permissions highlighting also    works in this mode.

      _u_s_e__f_i_l_e__t_o__g_u_e_s_s__t_y_p_e

           If this variable    is on (the default) it will spawn the
           file command to match the file types listed on the
           mc.ext file.

      _x_t_e_r_m__m_o_d_e

           If this variable    is on (default is off) when you    browse
           the file    system on a Tree panel,    it will    automatically
           reload the other    panel with the contents    of the
           selected    directory.

     TTTTeeeerrrrmmmmiiiinnnnaaaallll ddddaaaattttaaaabbbbaaaasssseeeessss
      The Midnight Commander provides a way    to fix your system
      terminal database without requiring root privileges.    The
      Midnight Commander searches in the system initialization
      file (the mc.lib file    located    in the Midnight    Commander
      library directory) or    in the ~/.mc/ini file for the section
      "terminal:your-terminal-name"    and then for the section
      "terminal:general", each line    of the section contains    a key
      symbol that you want to define, followed by an equal sign
      and the definition for the key.  You can use the special \E
      form to represent the    escape character and the ^x to
      represent the    control-x character.

      The possible key symbols are:

      f0 to    f20    Function keys f0-f20
      bs         backspace
      home        home key
      end        end key
      up        up arrow key
      down        down arrow key
      left        left arrow key
      right        right arrow key
      pgdn        page down key
      pgup        page up    key
      insert    the insert character
      delete    the delete character
      complete    to do completion

      For example, to define the key insert    to be the Escape + [ +
      O + p, you set this in the ini file:

      insert=\E[Op

      The _c_o_m_p_l_e_t_e key symbol represents the escape    sequences used



     Page 47                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      to invoke the    completion process, this is invoked with M-
      tab, but you can define other    keys to    do the same work (on
      those    keyboard with tons of nice and unused keys
      everywhere).


     FFFFIIIILLLLEEEESSSS
      /usr/freeware/lib/mc.hlp

           The help    file for the program.

      /usr/freeware/lib/mc/mc.ext

           The default system-wide extensions file.

      ~/.mc/ext

           User's own extension, view configuration    and edit
           configuration file.  They override the contents of the
           system wide files if present.

      /usr/freeware/lib/mc/mc.ini

           The default system-wide setup for the Midnight
           Commander, used only if the user    lacks his own
           ~/.mc/ini file.

      /usr/freeware/lib/mc/mc.lib

           Global settings for the Midnight    Commander.  Settings
           in this file are    global to any Midnight Commander, it
           is useful to define site-global terminal    settings.

      ~/.mc/ini

           User's own setup. If this file is present then the
           setup is    loaded from here instead of the    system-wide
           startup file.

      /usr/freeware/lib/mc/mc.hint

           This file contains the hints (cookies) displayed    by the
           program.

      /usr/freeware/lib/mc/mc.menu

           This file contains the default system-wide applications
           menu.

      ~/.mc/menu

           User's own application menu. If this file is present it



     Page 48                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



           is used instead of the system-wide applications menu.

      ~/.mc/tree

           The directory list for the directory tree and tree view
           features.  Each line is one entry. The lines starting
           with a slash are    full directory names. The lines
           starting    with a number have that    many characters    equal
           to the previous directory. If you want you may create
           this file by giving the command "find / -type d -print
           | sort >    ~/.mc.tree". Normally there is no sense    in
           doing it    because    the Midnight Commander automatically
           updates this file for you.

      ./.mc.menu

           Local user-defined menu.    If this    file is    present    it is
           used instead of the home    or system-wide applications
           menu.

     LLLLIIIICCCCEEEENNNNSSSSEEEE
      This program is distributed under the    terms of the GNU
      General Public License as published by the Free Software
      Foundation. See the built-in help for    details    on the License
      and the lack of warranty.

     AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY
      The latest version of    this program can be found at
      ftp.nuclecu.unam.mx in the directory /linux/local and    from
      Europe at sunsite.mff.cuni.cz    in the directory /GNU/mc and
      at ftp.teuto.de in the directory /lmb/mc.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
      ed(1), gpm(1), mcserv(8), terminfo(1), view(1), sh(1),
      bash(1), tcsh(1), zsh(1).

      The Midnight Commander page on the World Wide    Web:
           http://mc.blackdown.org/mc

     AAAAUUUUTTTTHHHHOOOORRRRSSSS
      Miguel de Icaza ([e-mail]), Janne
      Kukonlehto ([e-mail]), Radek Doulik
      ([e-mail]), Fred Leeflang ([e-mail]),
      Dugan    Porter ([e-mail]), Jakub Jelinek
      ([e-mail]), Ching Hui
      ([e-mail]), Andrej Borsenkow
      ([e-mail]), Norbert Warmuth ([e-mail]),
      Mauricio Plaza ([e-mail]) and Paul    Sheer
      ([e-mail]) are the developers of this package;
      Alessandro Rubini ([e-mail]) has been
      especially helpful debugging and enhancing the program's
      mouse    support, John Davis ([e-mail]) also made



     Page 49                          (printed 6/7/98)






     mmmmcccc((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22220000    OOOOccccttttoooobbbbeeeerrrr    1111999999997777))))         mmmmcccc((((1111))))



      his S-Lang library available to us under the GPL and
      answered my questions    about it, and the following people
      have contributed code    and many bug fixes (in alphabetical
      order):

      Adam Tla/lka ([e-mail]), [e-mail] (Alex
      I. Tkachenko), Antonio Palama, DOS port
      ([e-mail]), Erwin van    Eijk
      ([e-mail]), Gerd Knorr ([e-mail]),
      Jean-Daniel Luiset ([e-mail]), Jon    Stevens
      ([e-mail]), Juan Francisco Grigera, Win32 port
      ([e-mail]), Juan Jose Ciarlante
      ([e-mail]), Ilya Rybkin
      ([e-mail]), Marcelo Roccasalva
      ([e-mail]), Massimo Fontanelli
      ([e-mail]), Pavel Roskin
      ([e-mail]), Sergey Ya. Korshunoff
      ([e-mail]), Thomas Pundt ([e-mail]-
      muenster.de),    Timur Bakeyev ([e-mail]),
      Tomasz Cholewo ([e-mail]), Torben
      Fjerdingstad ([e-mail]), Vadim Sinolitis
      ([e-mail])    and Wim    Osterholt
      ([e-mail]).

     BBBBUUUUGGGGSSSS
      See the file TODO in the distribution    for information    on
      what remains to be done.

      If you want to report    a problem with the program, please
      send mail to this address: [e-mail].

      Provide a detailed description of the    bug, the version of
      the program you are running (mc -V display this
      information),    the operating system you are running the
      program on and if the    program    crashes, we would appreciate a
      stack    trace.



















     Page 50                          (printed 6/7/98)